home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet multimedia / Animacje, filmy i prezentacje / Edytory i konwertery filmow / Gordian Knot rippack 0.35.0 pack2 / GordianKnot.RipPack.0.35.0.Setup.2.exe / AvisynthPlugins / MVTools.xml < prev    next >
Extensible Markup Language  |  2004-08-17  |  20KB  |  308 lines

  1. ∩╗┐<?xml version="1.0" encoding="utf-8"?>
  2. <!--AviSynth plugin description version 1.1-->
  3. <plugin name="MVTools">
  4.   <description>Collection of filters (Blur, ConvertFPS, Denoise, Interpolate, Mask and others) which uses motion vectors generated by this plugin.</description>
  5.   <filters>
  6.     <filter name="MVAnalyse" category="Misc Plugins" helpfile="mvtools" type="clip">
  7.       <description>Produces backward and forward motion vectors: backward obtained by MVAnalyse(isb = true), and the other is forward MVAnalyse(isb = false).</description>
  8.       <colorspaces>
  9.         <colorspace>yv12</colorspace>
  10.       </colorspaces>
  11.       <parameters>
  12.         <parameter name="clip" type="clip" default="" max="0" min="0" step="0" optional="True" paramList="False">
  13.           <description />
  14.           <items />
  15.         </parameter>
  16.         <parameter name="bw" type="int" default="8" max="0" min="0" step="0" optional="True" paramList="False">
  17.           <description>bw, bh : They are the width and the height of a block. Value can only be 4 or 8. Larger blocks are less sensitive to noise, are faster, but also less accurate.</description>
  18.           <items />
  19.         </parameter>
  20.         <parameter name="bh" type="int" default="8" max="0" min="0" step="0" optional="True" paramList="False">
  21.           <description>bw, bh : They are the width and the height of a block. Value can only be 4 or 8. Larger blocks are less sensitive to noise, are faster, but also less accurate.</description>
  22.           <items />
  23.         </parameter>
  24.         <parameter name="pel" type="int" default="1" max="0" min="0" step="0" optional="True" paramList="False">
  25.           <description>The accuracy of the motion estimation. 1 means a precision to the pixel. 2 means a precision to half a pixel, 4 to a quarter of pixel and so on. Value can only be 1, 2, 4 or 8 ( beyond 8, it is useless and waste a lot of memory ). Default : 1. For the moment, it's the only possible value.</description>
  26.           <items />
  27.         </parameter>
  28.         <parameter name="lv" type="int" default="0" max="0" min="0" step="0" optional="True" paramList="False">
  29.           <description>The number of levels not used in the hierarchal analysis made while searching for motion vectors. The lower the better. It is kept variable for study's purposes only.</description>
  30.           <items />
  31.         </parameter>
  32.         <parameter name="fth" type="int" default="" max="0" min="0" step="0" optional="True" paramList="False">
  33.           <description>Not used anymore, made useless by lambda.</description>
  34.           <items />
  35.         </parameter>
  36.         <parameter name="sadt" type="int" default="" max="0" min="0" step="0" optional="True" paramList="False">
  37.           <description>Not used anymore, made useless by lambda and the speed gain.</description>
  38.           <items />
  39.         </parameter>
  40.         <parameter name="mpt" type="int" default="" max="0" min="0" step="0" optional="True" paramList="False">
  41.           <description />
  42.           <items />
  43.         </parameter>
  44.         <parameter name="st" type="int" default="0" max="0" min="0" step="0" optional="True" paramList="False">
  45.           <description>st is the type of search, and stp is a setting for this : st = 0 : 'OneTimeSearch'. stp is the step between each vectors tried. st = 1 : 'NStepSearch'. N is set by stp. st = 2 : Logarithmic search, also named Diamond Search. stp is the initial step search. st = 3 : Exhaustive search, stp is the radius. It is slow, but it gives the best results, SADwise. </description>
  46.           <items />
  47.         </parameter>
  48.         <parameter name="stp" type="int" default="1" max="0" min="0" step="0" optional="True" paramList="False">
  49.           <description>See st.</description>
  50.           <items />
  51.         </parameter>
  52.         <parameter name="isb" type="bool" default="" max="0" min="0" step="0" optional="True" paramList="False">
  53.           <description>allows to choose between a forward search ( between the current frame and the previous one ) and a backward one ( between the current frame and the following one ). isb = false means forward search.</description>
  54.           <items />
  55.         </parameter>
  56.         <parameter name="lambda" type="int" default="0" max="0" min="0" step="0" optional="True" paramList="False">
  57.           <description>set the coherence of the field of vectors. The higher, the more coherent. However, if set too high, some 'true' motion vectors can be missed. Default is 0, but values around 2000 are strongly recommended and will be made defaults in the next release.</description>
  58.           <items />
  59.         </parameter>
  60.       </parameters>
  61.     </filter>
  62.     <filter name="MVBlur" category="Sharpen/Soften Plugins" helpfile="mvtools" type="clip">
  63.       <description>Allows to create a motion blur. The motion blur is created by interpolating frames between the current frame and both next and previous frames, and then make a weighted mean of these interpolations.</description>
  64.       <colorspaces>
  65.         <colorspace>yv12</colorspace>
  66.       </colorspaces>
  67.       <parameters>
  68.         <parameter name="clip" type="clip" default="" max="0" min="0" step="0" optional="True" paramList="False">
  69.           <description />
  70.           <items />
  71.         </parameter>
  72.         <parameter name="mvsbw" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  73.           <description>the backword motion vector</description>
  74.           <items />
  75.         </parameter>
  76.         <parameter name="mvsfw" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  77.           <description>the forword motion vector</description>
  78.           <items />
  79.         </parameter>
  80.         <parameter name="nb" type="int" default="10" max="0" min="0" step="0" optional="True" paramList="False">
  81.           <description>decides how many interpolations are made. The more, the better, and the slower.</description>
  82.           <items />
  83.         </parameter>
  84.         <parameter name="rl" type="float" default="0.5" max="0" min="0" step="0" optional="True" paramList="False">
  85.           <description>is equivalent to the speed of a camera's shutter. The higher, the stronger the motion blur. It's unit is in fps.</description>
  86.           <items />
  87.         </parameter>
  88.         <parameter name="fbw" type="int" default="2" max="0" min="0" step="0" optional="True" paramList="False">
  89.           <description>allows to increase the size of the blocks that are moved along the motion vectors. For example fbw = 2 will increase the block by a 2-pixels margin. This allows less artifacting, but leads to a slightly less imprecise motion blur ( it will be less directionnal ).</description>
  90.           <items />
  91.         </parameter>
  92.         <parameter name="wf" type="string" default="uniform" max="0" min="0" step="0" optional="True" paramList="True">
  93.           <description>wf = "uniform" : Uniform weighting ( all the weights are equal to 1 ). wf = "ramp" : the weight is proportionnal to the time between the interpolation and the current frame. wf = "revramp" : it's the contrary. wf = "hat" : it begins with a ramp, and finish like a revramp.</description>
  94.           <items>
  95.             <item>uniform</item>
  96.             <item>ramp</item>
  97.             <item>revramp</item>
  98.             <item>hat</item>
  99.           </items>
  100.         </parameter>
  101.       </parameters>
  102.     </filter>
  103.     <filter name="MVCompensate" category="Misc Plugins" helpfile="mvtools" type="clip">
  104.       <description>Do a full motion compensation of the frame.</description>
  105.       <colorspaces>
  106.         <colorspace>yv12</colorspace>
  107.       </colorspaces>
  108.       <parameters>
  109.         <parameter name="clip" type="clip" default="" max="0" min="0" step="0" optional="True" paramList="False">
  110.           <description />
  111.           <items />
  112.         </parameter>
  113.         <parameter name="vectors" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  114.           <description>It means that the blocks pointed by MV in the previous frame ( or following, it depends on the setting of MVAnalyse ) will be moved along the vectors to reach their places in the current frame.</description>
  115.           <items />
  116.         </parameter>
  117.       </parameters>
  118.     </filter>
  119.     <filter name="MVConvertFPS" category="Misc Plugins" helpfile="mvtools" type="clip">
  120.       <description>Will change the framerate of the clip, without changing its length.</description>
  121.       <colorspaces>
  122.         <colorspace>yv12</colorspace>
  123.       </colorspaces>
  124.       <parameters>
  125.         <parameter name="clip" type="clip" default="" max="0" min="0" step="0" optional="True" paramList="False">
  126.           <description />
  127.           <items />
  128.         </parameter>
  129.         <parameter name="mvbw" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  130.           <description>the backword motion vector</description>
  131.           <items />
  132.         </parameter>
  133.         <parameter name="mvfw" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  134.           <description>the forword motion vector</description>
  135.           <items />
  136.         </parameter>
  137.         <parameter name="nb" type="int" default="1" max="0" min="0" step="0" optional="True" paramList="False">
  138.           <description>The number of frames built in order to create one interpolate frame.</description>
  139.           <items />
  140.         </parameter>
  141.         <parameter name="rl" type="float" default="0" max="0" min="0" step="0" optional="True" paramList="False">
  142.           <description>camera's shutter speed</description>
  143.           <items />
  144.         </parameter>
  145.         <parameter name="fbw" type="int" default="4" max="0" min="0" step="0" optional="True" paramList="False">
  146.           <description>fbw,  sbw and  rbw allows to increase the size of the blocks moved.</description>
  147.           <items />
  148.         </parameter>
  149.         <parameter name="sbw" type="int" default="0" max="0" min="0" step="0" optional="True" paramList="False">
  150.           <description>fbw,  sbw and  rbw allows to increase the size of the blocks moved.</description>
  151.           <items />
  152.         </parameter>
  153.         <parameter name="rbw" type="int" default="" max="0" min="0" step="0" optional="True" paramList="False">
  154.           <description>fbw,  sbw and  rbw allows to increase the size of the blocks moved.</description>
  155.           <items />
  156.         </parameter>
  157.         <parameter name="bvt" type="int" default="" max="0" min="0" step="0" optional="True" paramList="False">
  158.           <description>A threshold which decides whether a motion vector is valid or not. The default value makes all vectors valid.</description>
  159.           <items />
  160.         </parameter>
  161.         <parameter name="fps" type="float" default="" max="0" min="0" step="0" optional="False" paramList="False">
  162.           <description>The new framerate.</description>
  163.           <items />
  164.         </parameter>
  165.         <parameter name="wf" type="string" default="uniform" max="0" min="0" step="0" optional="True" paramList="False">
  166.           <description>The normalization function. See MVBlur.</description>
  167.           <items />
  168.         </parameter>
  169.       </parameters>
  170.     </filter>
  171.     <filter name="MVDenoise" category="Temporal Smoothers" helpfile="mvtools" type="clip">
  172.       <description>Makes a basic temporal denoising with motion compensation. Both previous and following frames are motion compensated and then merged into the current frame. The two thresholds are used to prevent artifacts.</description>
  173.       <colorspaces>
  174.         <colorspace>yv12</colorspace>
  175.       </colorspaces>
  176.       <parameters>
  177.         <parameter name="clip" type="clip" default="" max="0" min="0" step="0" optional="True" paramList="False">
  178.           <description />
  179.           <items />
  180.         </parameter>
  181.         <parameter name="mvbw" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  182.           <description>the backword motion vector</description>
  183.           <items />
  184.         </parameter>
  185.         <parameter name="mvfw" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  186.           <description>the forword motion vector</description>
  187.           <items />
  188.         </parameter>
  189.         <parameter name="thT" type="int" default="10" max="0" min="0" step="0" optional="True" paramList="False">
  190.           <description>Decides whether the pixel which comes from the previous or the following frame has to be taken into account. If this pixel differs more than thT from the pixel of the current frame, it is not used.</description>
  191.           <items />
  192.         </parameter>
  193.         <parameter name="sadT" type="int" default="160" max="0" min="0" step="0" optional="True" paramList="False">
  194.           <description>Decides whether the block has changed or not ( same principle as  thSCD1 ). If it has changed, the pixel aren't merged with those of the previous or following frame.</description>
  195.           <items />
  196.         </parameter>
  197.       </parameters>
  198.     </filter>
  199.     <filter name="MVInterpolate" category="Misc Plugins" helpfile="mvtools" type="clip">
  200.       <description>Allows to shift temporally the video from a non integer number of frames, between 0.0 and 1.0.</description>
  201.       <colorspaces>
  202.         <colorspace>yv12</colorspace>
  203.       </colorspaces>
  204.       <parameters>
  205.         <parameter name="clip" type="clip" default="" max="0" min="0" step="0" optional="True" paramList="False">
  206.           <description />
  207.           <items />
  208.         </parameter>
  209.         <parameter name="mvbw" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  210.           <description>the backword motion vector</description>
  211.           <items />
  212.         </parameter>
  213.         <parameter name="mvfw" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  214.           <description>the forword motion vector</description>
  215.           <items />
  216.         </parameter>
  217.         <parameter name="nb" type="int" default="5" max="0" min="0" step="0" optional="True" paramList="False">
  218.           <description>nb, fbw, sbw, rbw, bvt and wf work the same way as in MVBlur and MVConvertFPS.</description>
  219.           <items />
  220.         </parameter>
  221.         <parameter name="bl" type="float" default="0.4" max="0" min="0" step="0" optional="True" paramList="False">
  222.           <description>bl and el define the beginning and the end of the interpolation. If bl is different from el, the created frame is slightly blured. The interpolation is made between the current frame and the previous one.</description>
  223.           <items />
  224.         </parameter>
  225.         <parameter name="el" type="float" default="0.6" max="0" min="0" step="0" optional="True" paramList="False">
  226.           <description />
  227.           <items />
  228.         </parameter>
  229.         <parameter name="fbw" type="int" default="4" max="0" min="0" step="0" optional="True" paramList="False">
  230.           <description />
  231.           <items />
  232.         </parameter>
  233.         <parameter name="sbw" type="int" default="0" max="0" min="0" step="0" optional="True" paramList="False">
  234.           <description />
  235.           <items />
  236.         </parameter>
  237.         <parameter name="rbw" type="int" default="0" max="0" min="0" step="0" optional="True" paramList="False">
  238.           <description />
  239.           <items />
  240.         </parameter>
  241.         <parameter name="bvt" type="int" default="35000" max="0" min="0" step="0" optional="True" paramList="False">
  242.           <description />
  243.           <items />
  244.         </parameter>
  245.         <parameter name="wf" type="bool" default="uniform" max="0" min="0" step="0" optional="True" paramList="False">
  246.           <description />
  247.           <items />
  248.         </parameter>
  249.       </parameters>
  250.     </filter>
  251.     <filter name="MVMask" category="Misc Plugins" helpfile="mvtools" type="clip">
  252.       <description>Creates a motion mask from the motion vectors' length. It builds a better mask than  MotionMask (  MaskTools ) because motion vectors are a lot more reliable than the algorithm of MotionMask.</description>
  253.       <colorspaces>
  254.         <colorspace>yv12</colorspace>
  255.       </colorspaces>
  256.       <parameters>
  257.         <parameter name="clip" type="clip" default="" max="0" min="0" step="0" optional="True" paramList="False">
  258.           <description />
  259.           <items />
  260.         </parameter>
  261.         <parameter name="vectors" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  262.           <description>Creates a motion mask from the motion vectors' length. It builds a better mask than  MotionMask (  MaskTools ) because motion vectors are a lot more reliable than the algorithm of MotionMask.</description>
  263.           <items />
  264.         </parameter>
  265.         <parameter name="ml" type="int" default="100" max="255" min="0" step="1" optional="True" paramList="False">
  266.           <description>The mask is output only on the luma plane. 0 means no motion at all ( the length of the motion vector is null ), whereas 255 means maximum motion,.</description>
  267.           <items />
  268.         </parameter>
  269.         <parameter name="gamma" type="float" default="1.0" max="0" min="0" step="0" optional="True" paramList="False">
  270.           <description>Used to defined the relation length - value. gamma = 1.0 implies a linear relation, whereas gamma = 2.0 gives a quadratic relation.</description>
  271.           <items />
  272.         </parameter>
  273.       </parameters>
  274.     </filter>
  275.     <filter name="MVShow" category="Misc Plugins" helpfile="mvtools" type="clip">
  276.       <description>Shows the motion vectors.</description>
  277.       <colorspaces>
  278.         <colorspace>yv12</colorspace>
  279.       </colorspaces>
  280.       <parameters>
  281.         <parameter name="clip" type="clip" default="" max="0" min="0" step="0" optional="True" paramList="False">
  282.           <description />
  283.           <items />
  284.         </parameter>
  285.         <parameter name="vectors" type="clip" default="" max="0" min="0" step="0" optional="False" paramList="False">
  286.           <description>motion vectors</description>
  287.           <items />
  288.         </parameter>
  289.         <parameter name="scale" type="int" default="1" max="0" min="0" step="0" optional="True" paramList="False">
  290.           <description>Alows to enlarge the motion vectors, in order for example to gain in accuracy.</description>
  291.           <items />
  292.         </parameter>
  293.         <parameter name="sil" type="int" default="0" max="0" min="0" step="0" optional="True" paramList="False">
  294.           <description>Allows to see a different level of analysis ( when searching for motion vectors, a hierarchal analysis is done, and it may be interesting to see what happens at higher levels ).</description>
  295.           <items />
  296.         </parameter>
  297.         <parameter name="til" type="int" default="20000" max="0" min="0" step="0" optional="True" paramList="False">
  298.           <description>Tolerance threshold. If the distorsion induced by the motion vector is over tol the vector isn't shown.</description>
  299.           <items />
  300.         </parameter>
  301.         <parameter name="showsad" type="bool" default="false" max="0" min="0" step="0" optional="True" paramList="False">
  302.           <description>Allows to show the mean SAD after compensating the picture.</description>
  303.           <items />
  304.         </parameter>
  305.       </parameters>
  306.     </filter>
  307.   </filters>
  308. </plugin>